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Field Of The Invention 

The present invention relates to networked computer systems in which a plurali 
of interconnected computer systems exchange data. 

BACKGROUND OF THE INVENTION 

The present invention relates to computer systems interconnected by a network, suitably 
configured to transfer data between one another. A computer system connected to the 
network processes data from a plurality of data sources. A data source can be an input device 
attached to the computer system, or can be a storage device, memory, database, or other 
computer system attached either locally or remotely to the computer system via a network. In 
the network of computers, at any given time, a computer system may assume a specific role, 
relative to the processing of data. A computer system that sends a request for data from 
another computer system is said to be a Client system 1 . The computer system that processes 
requests from other computer systems is said to be a Server system 2. When a Client sends a 
request for data to a Server, the Server may retrieve some of the requested data from its local 
resources, and some of the data from an External source 3 on the network. The Server 2 in 
this case acts as a Client to an External source 3, requesting the appropriate data, and the. 
External source 3 acts as a Server. Thus, a computer system on the network may at one time 
perform the role of a Client, and at another time perform the role of a Server. 

Servers on the network are designed to satisfy requests for a particular type of data. For 
example, a database server may be designed to accept Structured Query Language (SQL) 
requests from clients. The database server will execute the SQL and return the resulting 
database data to the requesting client. A Hyper Text Transfer Protocol (HTTP) server (or 
Web Server) accepts HTTP request from client systems (generally Web Browsers), processes 



the requests, and returns the resulting Hyper Text Markup Language (HTML) to the client. In 
an enterprise business . environment, such as the Information Processing environment of a 
large company, a Server system may accept requests for customer account information. A 
Client may send the request to the Server in an agreed-upon format, and the Server locates the 
information within its system or a connected system, then returns the customer account 
information to the Client Frequently, in the enterprise business environment, the nature of 
the large systems involved dictates that the data exchange uses a custom data format instead 
of an industry standard such as SQL or HTML. 

Large corporations often house data in a multitude of sources, such as a host, database, server, 
or other information source. Often, one computer system may need to retrieve data from 
many other systems in order to perform its function. Systems in this environment contain 
complex programs that understand the intricacies of interfacing to each system that contains a 
U data item in need. Such programs are complex to write and maintain, require great expense to 
P development and modify, and are large in size due to the amount of code required for the 
H large number of interfaces. In addition, typical systems access data sequentially, thus perform 

M operations slowly more slowly than if data could be retrieved in parallel. More advanced 

n 

systems perform some data retrievals in parallel, but the complexity of this type of system 
p j requires greatly more experienced programmers and testers, thus significantly increasing the 
■ . cost of system development. Finally, the code developed to interface to each system and each 
U data source is not easily reused in other systems in the enterprise for a variety of reasons, 
■f * Program A may be a customer service application and may access servers 1 , 2, and 3. 
p Program B developed by another group may be a billing system that accesses servers 1, 2, and 
M 4. Some reasons for low success rate of reuse are the fact that programs perform vastly 

different functions (service vs. billing), so developers often do not recognize the possibilities 
of reusing code. Tools to assist in reuse are not widely used, developers are generally slow to 
be convinced that existing components will precisely fit their needs, and current engineering 
practices that emphasize reuse have not been widely adopted in many corporations. In the 
cases where code is reused, it often is copied and customized by a programmer, requiring 
work for the customization and testing for the resulting implementation. 

When a Client requires data from many different sources, it must contain a method and 
apparatus to send a request to each Server providing each type of required data. The Client 
also must have a method and apparatus to both receive the response data from the Server and 
to make sensible use of the data. Likewise, a Server needs a method and apparatus to process 



requests from Clients, and return resulting data to them. In the typical enterprise computer 
system environment, the methods and apparatuses for both Client and Server must be 
developed, integrated, tested, and deployed. 

The methods and apparatuses necessary for a Client to usefully retrieve and process data from 
a Server is called an Interface. The code components involved in an Interface are shown in 
Figure 3. The Client makes a request from the Request Code 4, which contains the method 
and apparatus to send the request to the Server and receive the result. The Request Code uses 
information from the Data Source Description Code 5 component located on the Client, 
which contains the method and apparatus to identify how to physically connect and maintain 
a connection to the Server. The Server component contains a Service Processor 6 that 
contains the method and apparatus to receive the request, cause the Server to process the 
request, then return the results to the Client. The Request Code for the Client receives the 
request, then identifies and interprets each element of information in the return using the 
method and apparatus contained in the Parsing Code 7. In total, 4 components must be 
developed for each interface. 

Many computer systems use standard interface components such as those supporting SQL 
requests to database management systems (DBMS) to drastically reduce development time. 
Unfortunately, many computer systems in large enterprise environments require interfaces 
customized for the particular Client and Server pair. For these systems, a large number of 
interface components must be developed. As an example, assume two client systems 
interface with 4 server systems as shown in Figure 3. Each server requires a Service 
Processor. Each Client requires Request Code, Server Description Code, and Parsing Code 
for each interface, therefore Client 1 requires 9 components and Client 2 requires 9 
components, for a total of 22 total development components for the depicted interfaces. It is 
possible for Clients to share interface components, for example, Client 2 can reuse the code 
developed in Client 1 for its interface to Server 1. However, it is more often the case in large 
enterprise environments for Client 1 and Client 2 to be developed by separate groups, and the 
opportunity to reuse the code is not exploited. 

There is a need for an interface strategy that organizes the implementation of the interface 
components, so that interface components are only developed a single time, regardless of the 
number of Clients implementing similar interfaces to various servers. This would result in 



fewer development resources being expended, because many of the interface components 
would be developed a single, time, instead of once for each Client system. 

Client systems generally request data in a sequence of steps. For example, a customer service 
application may perform the following sequence of processing steps: 1) obtain a customer 
phone number from the user, 2) request account information such as name, address, and 
account number from a Server, 3) send request to another Server to retrieve current order 
information, 4) send a request to the same server to retrieve order detail information, 5) send 
request to yet another Server to request service contact history. Each request in the sequence 
requires a different parameter in order to carry out the request. The original customer account 
request requires the customer's phone number. The request to retrieve order information 
requires an account number that is retrieved with the account information. The request to 
retrieve order detail requires an order number, which is retrieved with the order information. 

^ The request to return service contact information requires an account number. The 

Q 

q cumulative data comprising customer account, order information and service history can be 

M said to be a single Data File constituting the current status of the customer. The specification 

jl!J of the contents of a Data File is said to be the Document Definition of the Data File. Though 

p j a more formal specification is required in practice, in the current example, the Document 

fa Definition would state that the Data File contains account, order, and service history 

L h information. A Client can thus request a single data file for a particular customer, even 

f * though the source information is stored in separate Servers. 
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P Szlam et al. (Patent Number 5,675,637) describe a means and apparatus for obtaining and 
r * displaying data with sequentially dependent information. However, there is a need to 

automatically obtain sequences of information from a plurality of data sources where vastly 
different Clients are supported. There is a need for defining the cumulative data file 
independent of any display, rendering, or presentation system, so that Clients of vastly 
differing types can obtain full information without developing interface code. For example, a 
customer data file as in the above example would be useful for a desktop client, a browser- 
based client, an Interactive Voice Response (IVR) unit or Voice Response unit (VRU), a 
hand-held computer, an invoice printing system, and a vast assortment of other uses. 
Many servers provide conglomerations of data in a predetermined format. But since different 
types of clients have different formatting needs, there is a need for the information in the 
resulting data file to be formatted according to client preference, without having to create a 
new Document Definition for the data file. If a client has a particular format requirement, 



there is a need for the data file to be made to conform to this new format for this client, and 
for said new format to be further available to other clients upon request. The ability to render 
the same information in different formats is enabled by abstracting the information itself from 
the format of the information. 

Current DBMS Servers satisfy requests for data that is generally row-based. Row-based data 
is appropriate for clients in many instances, such as requesting data that will populate a visual 
table on a display screen. Often, a Client desires more complex information, as in the case of 
the customer Data File in the above example. A DBMS cannot process a request for an 
arbitrarily complex hierarchy in a single request, because requests to a DBMS are row-based. 
Instead, multiple requests to the Server are required to obtain data representing an arbitrarily 
complex set of data. There is a need for data servers to support arbitrarily complex 
hierarchies of data. International standards such as those defining SGML and XML support 
jj data file formats that represent arbitrarily complex hierarchies of data. Hierarchies can, of 
p course, represent rows of data just as a DBMS does, plus other arbitrary sets of data. 

J J Current Servers supporting delivery of Data Files generally retrieve the Data File from a 

p J source, or generate the Data File in code, then return it to the Client. The resulting Data File 

P J is fixed in size and information content, regardless of whether the client needs the entire set 

j, * of information. For clients requiring less than the entire set of information, this very 

M inefficient, as unneeded data is generated, formatted, and transmitted to the client. The client 

y must read and parse the entire Data File. There is a need for clients to be able to flexibly 

p select only those portions of the Data File that suits their particular purpose at the time. 

Current DBMS's are Servers that act on data requests of clients. One advanced data 
manipulation feature of these systems (Oracle, Sybase, Informix, Microsoft SQL Server) is to 
perform a join operation on table data. Oracle is one example DBMS that allows a join 
across data tables on different Servers, even servers ninning different vendor's DBMS. But 
the join is limited to row-based tables, with the result of the join being row data. 

There is a need for Clients to be able to request a join of data that has rich, hierarchical 
information, such as the customer Data File in the above example. The join operation should 
also not be constrained to operate on a particular source of data, such as a DBMS, but rather 
should work on data from any source whatsoever. 



Current Servers can easily handle Data Files that are completely static. However, if some or 
all of the data file is dynamic, an intricate program must be developed to produce the dynamic 
portions and insert them appropriately into the Data File. Microsoft's Active Server Pages 
and Allaire's Cold Fusion are examples of systems that simplify mixing dynamic with static 
data for internet-based Data Files. However, these systems do not provide the capability to 
generate arbitrary levels of hierarchical data, so are limited in the complex data structures 
they can generate. There is a need to easily define static and dynamic portions of a Data File, 
while not limiting the complexity of the resulting data. 

Such a method is difficult to change when the needs of the client system changes. The 
present invention provides a single data file generation engine, which can construct an infinite 
number of different types of data files. To enable the generation of a new type of data file, a 
user simply creates a new DDF and ensures the DDF is accessible to the Data Server. To 
Jjj make a modification to an existing type of data file, the user simply edits the DDF with the 
p current inventions Authoring System, then the next time that type of data file is requested, the 
f h new format is used. All changes are effected with no changes to the software code, therefore 
p no programmer must be hired to make the changes. New data file types and changes to 
W existing data file types are easily made by an administrator. 

ry 

[J OBJECTS AND ADVANTAGES 

y The present invention provides several objects and advantages as follows: . 

M 1 . Interface code is organized so that a plurality of Clients need only one set of Request 

Code, Data Source Description, and Parsing Code. Requests are all passed through to a 
Hierarchical Data System (HDS), which retrieves the knowledge of how to construct the 
various dynamic portions of data, and pass the data back in a Client designated format. 
The format can be XML or other industry or organization standard where parsing code is 
readily available. 

2. A series of interdependent data requests can be defined in a Document Definition File 
(DDF). Elements in the DDF can reference previously generated data as keys, therefore 
the Client need not be concerned with ordering of requests. A Client can request the 
entirety of data in a single request, then process the data as it sees fit. 

3. Data is defined abstractly as a hierarchy of elements, able to model any data set. The 
generation of the data is independent of the output of the data to the client. The output 
format of the resulting data file can be selected by the Client, for example, XML, key- 



value pair, binary stream, ASCII stream, etc. Supported formats can be extended, 
resulting in an infinite number of possible formats. 

4. Conditional data element generation is provided, so that a Client can select portions of a 
data file of interest, filtering out those that are not of concern at a particular time. A 
Client in one instance can request that data sections A, B, and C be generated and 
delivered. In another instance, the Client may not need element B, so it will request the 
same data file with only data section A and C, thus saving the time and expense of 
generating, formatting, then delivering unneeded components. 

5. A Join operation is provided, similar to the database Join operation, but with extension to 
work against hierarchical data, and data from any available source, not just database data. 



Further objects and advantages of the present invention will become apparent from a 
consideration of the drawings and ensuing description. 

M 
P 

p SUMMARY OF THE INVENTION 

f * The present invention overcomes the limitations of the prior art by providing a highly flexible 
p Hierarchical Data Server (HDS) and accompanying Document Definition Authoring System. 
P J The Authoring System creates Document Definition Files (DDF), which specify 
^ hierarchically related elements, each of which is capable of generating dynamic data. A 
M Client sends a request to the HDS, indicating which DDF is desired, and a list of parameter 
p substitutions that the HDS is to apply to the DDF. The HDS processes all elements in the 
h j DDF, dynamically generating data, then outputs the data in a format requested by the Client. 

w 

Figure 15 shows an overview of the HDS and Authoring System. A Client system 200 
requiring data from various Enterprise System 202, including databases, hosts, and any other 
data source, will arrange for a new DDF 204 to be created using the Authoring System 203. 
The Authoring System 203 is used to define the structure and data sources for each element of 
data requested, and the parameters that can be used to customize the DDF 204 for any 
particular Client's purpose. The DDF 204 is stored in a location convenient for the HDS 201 
to access it upon request. 

When the Client 200 needs the data, it sends a request over the interface 205 to the HDS, 
specifying the DDF name and any needed parameters. The HDS 201 reads the DDF into 
memory, performs parameter substitution, and executes each element. The execution of 
elements is expected to cause a plurality of data requests to be processed over the Data 



Transactions Interface 206, retrieving data from the various Enterprise Systems 202, and 
returning the data over the interface to be placed in a DDF element on the HDS 201. After all 
elements are fully executed, the HDS 201 formats the resulting data into a Data File, and 
transmits the Data back to the Client 200 over the interface 205. 



BRIEF DESCRIPTION OF THE DRAWINGS 

A preferred embodiment of the present invention will be described below relative to the following 
figures. 

Figure 1, Typical Client-Server Computer System shows the typical prior-art interactions of 
communicating computers, especially client-server systems. 

Figure 2, Client-Server Code Components, shows typical prior-art code components involved in the 
interfacing of computers. 

Figure 3, Multiple Clients and Servers, shows the typical prior-art interactions of multiple Clients 
C3 interfacing to multiple Servers. 

^ Figure 4, Preferred Embodiment of Authoring System, presents the graphical computer program 
p layout of an authoring system. 

Figure 5, System Parameter File, is an example parameter file used by a preferred embodiment of the 
invention to dictate processing by the Authoring System and the Hierarchical Data Server (HDS). 
Figure 6, Hierarchical Data Server Process, is a flowchart describing the processing steps of the 
j*[ preferred embodiment. 

|ij Figure 7, Process Element, is a flowchart describing the processing steps taken by the HDS to 
jjf process an element. 

Figure 8, Process Children, is a flowchart describing the processing steps taken by the HDS to 

process the children element of an element. 

Figure 9, Format Memory into Data File, is a flowchart describing the processing steps taken by the 
HDS to format DDF elements after they have been executed. 

Figure 10, Output Element, is a flowchart describing the processing steps taken by the HDS to format 
and output an element. 

Figure 11, SQL BuildSubtree, is a flowchart describing the processing steps taken by the HDS to 
execute an element containing an SQL statement, thereby dynamically generating data for the 
element. 

Figure 12, CMD BuildSubtree, is a flowchart describing the processing steps taken by the HDS to 
execute an element containing a shell command, thereby dynamically generating data for the element. 



Figure 13, Join Code, is a C++ coding example, demonstrating the important steps required in the 
processing of a Join operation. 

Figure 14, Substitution Code, is a C++ coding example, demonstrating the important steps required 
in performing parameter substitution prior to execution of dynamic elements. 
Figure 15, Overview of a Hierarchical Data Server and DDF Authoring System, is a block diagram 
depicting a portion of a network of computers suitable for practicing the preferred embodiment of the 
present invention. 

Figure 1 6, DDF Document Structure, is a diagram depicting the element data structures useful in 
implementing the preferred embodiment of the present invention. 

DETAILED DESCRIPTION OF THE INVENTION 

The preferred embodiment of the present invention provides a Hierarchical Data Server which 
reads a Document Definition File upon request from a Client, performs parameter substitution 
g as specified in the Client's request, then visits each element in the Document Definition File, 
Q dynamically executing each element until all elements are complete, then formats the 
J* resulting data into a Data File in the format requested by the Client. A Document Definition 
P Authoring System is provided to assist in the construction and maintenance of Document 
fj j Definition Files. 

ru 

^ Document Definition File 

j* According to a broad aspect of a preferred embodiment of the invention, a computer system specifies 
y the content, sources, and method of generation of a collection of data and stores this in a file (a 
p Document Definition File, DDF). The type of data that can be defined is very general and is 
¥ - restricted only in that it must fit into a hierarchical structure. Importantly, the DDF is not limited to 
information of a static or unchanging nature. Instead, the DDF is a hierarchy of elements, each of 
which may specify static data, or indicate a mechanism to fetch data dynamically. Figure 16 shows a 
pictorial view of the element hierarchy of a DDF. Formally, a DDF is defined as a list of elements, 
where each element is defined as consisting of the following components: 

1 . Type 220: a character string naming the type of the element 

2. Value 22 1 : a character string representing the value of this element 

3. Attribute List 222: list of attributes represented as key-value pairs, each key-value pair 
consisting of: 

a) Key: a character string naming the attribute 

b) Value: a character string representing the value of the attribute 

4. Style 225: a character string designating the output formatting for this element 



5. Children 223: a list of zero or more elements. 

As indicated above, each element contains, among other things, a list of zero or more elements 
representing the children elements of the present element. Thus, the mechanism is provided to build 
arbitrarily complex hierarchies of data. 



Addressable DDF Components 

Each component of each element in the DDF is addressable by specifying a complete path to the 
component. Since the DDF is a hierarchy of elements, it is convenient to think of components of the 
DDF as a file system. Just as files in a file system can be referenced with a full pathname, so can 
elements in a DDF. For example, the path /CUSTOMER/ORDER/ORDER JTEM specifies an 
element of Type ORDER JTEM that is a child of an element of Type ORDER, which itself is a child 
j;J of an element of Type CUSTOMER. Such a path is called a reference. Whereas a file system houses 
p components of individual files, a richer scheme is required with DDFs to address individual 
V k components within an element. Also, although filenames are unique in a particular subdirectory, 
p many children of an element can normally do have identical Types. Thus the addressing scheme is 
p j expanded as follows: Each path component can take the form <Type>#<index> or 

<Type>.<attr>=<attr_value>, where <Type> is a the element Type, <index> is a number indicating 
(,& the sequence number of the element referenced, <attr> is an attribute key, and <attr_value> is an 
\ h attribute value. Several shortcuts are allowed: if <attr> is missing, "ID" is assumed. If #<index> is 
yj missing, the first instance of the given Type is referenced. Thus, 

p "/CUSTOMER#3/ORDER.NUM=003/ORDERJTEM.2" references ORDER ITEM with attribute 
ID-2, which is the child of element ORDER with attribute NUM=003, which is the 3 rd element of 
Type "CUSTOMER" in the root level of the document. 

The previous example begins with the character 7\ This character at the beginning of an address 
specifies that the reference begins at the root of the element hierarchy in the document. If the slash is 
missing, the reference is a relative reference. If processing is currently occurring on the element of 
Type ORDER, with attribute NUM=003, a relative reference such as "ORDER JTEM.2" refers to a 
child element of the current element, with Type ORDERJTEM and attribute ID=2. As in a file 
system, the relative reference ".." refers to the current element's parent, and "V" refers to the current 
element. If processing again is occurring on the element of Type ORDER, with attribute NUM=003, 
the reference "../ORDER#l" refers to the first element of type ORDER that is a child of the current 
CUSTOMER element. 



Replacement Operator 

Elements in a DDF can specify reference to other elements in the DDF. By prefixing a reference 
with the special replacement operator "%%", direction is given to replace the reference with the 
value of the reference. For example, 

%%/CUSTOMER#3/ORDER.NUM=003/ORDER_ITEM.NAME is a directive to replace the string 
"%%/CUSTOMER#3/ORDER.NUM=003/ORDER_ITEM.2" with the Value component of the 
element with Type ORDER ITEM and ED=2. 

Executable Elements 

Elements in the DDF can be either static or dynamic. Static elements are defined with element 
components that do not change. Dynamic elements must be executed in order to generate data for the 

M element. For example, an executable element may generate data from a DBMS by sending an SQL 

g statement to the DBMS. The result is a sequence of rows, each of which contain columns of data. 

Irfi Upon execution, the original element is updated to include a child element for each row retrieved. 

^ For each of these child elements, elements are constructed to contain each column within the row. 

K 

fy 

s The Data File 

\h Every element in the DDF is potentially executable. In addition, every generated child of an 
M executable element may itself be executable. Thus, provisions are made to visit and attempt to 
g execute every element. After an element is executed, its children are visited and they are executed if 
appropriately. The process continues recursively until all elements are executed. Once execution of 
all elements are complete, the set of elements are formatted and returned to a client. The resulting 
output is called a Data File (DF). 



Hierarchically Embedded Executable Elements 

The original executable element in the previous example specified an SQL statement. In addition, it 
may also contain a list of children elements, some of which may be executable. Upon generation of 
each element for the returned data rows, the original child elements are replicated in these elements. 
The replicated elements may make use of the newly generated elements by using relative references. 



1Z 



As an example, assume the original element contained the following SQL statement: "select 
ORDERED ATE, NUM from orders where CUSTOMER_ID=432". This query, when executed on 
an appropriate database, will return a list of rows containing a date and a number, one row for each 
order in the table for the customer with ID 432. Let's assume the following 3 rows are returned: 

02/27/1999 002 
03/01/1999 003 
03/02/1999 005 

This results in 3 new children for the original element, one for each row returned. Each of the three 
new elements would contain two generated elements, one containing the date, and one containing the 
order number. Let's assume now that the original element has a child element. The child element is 
replicated as a child in each of the 3 generated row-level elements above. The original child element 
can be executable, and can also refer to the newly generated children, having foreknowledge of what 
will be generated. In particular, it may be useful to execute an SQL statement that generates 
ORDER JTEM elements by referring to the generated NUM field. This SQL statement might look 
like this: "select NAME, ITEMJSfUM from ORDER JTEMS where ORDER JNTUM=%%./NUM". 
At execution time, %%./NUM is treated as a relative reference to the child element of type NUM. 
The Value field of this element is retrieved and used in place of "%%./NUM". The query is executed 
and additional children elements are created, expanding the hierarchy depth. The hierarchy can be 
endlessly extended with ever-deeper children, each of which are replicated then executed. 

DDF Parameters 

In another aspect of a preferred embodiment of the invention, a DDF can define parameters for a 
Client's use, so that a Client can specify customization for a generated Data File. A DDF that 
generates customer account data, for example, may define a DDF parameter for customer phone 
number. The DDF parameter can be defined anywhere, but it is convenient to define a standard 
location, which we will call the INPUT element. This is an element in the document of Type 
INPUT, where attributes can be stored as DDF parameters. The input attribute is generally created as 
a template attribute at the time the DDF is created. For example, the INPUT element of the customer 
account DDF may contain the attribute PHONE=l 1 12223333. A Client may request the customer 
account DDF, and specify a parameter substitution "/INPUT.PHONE=7195551212". Assuming the 
INPUT element is a root-level element, a processing engine would replace the value of the PHONE 
attribute with "7195551212" prior to executing any elements in the DDF. Execution would proceed, 



and presumably one or more executable elements would use a replacement operator referring to this 
input parameter. As an example, an SQL select statement might contain the reference 
%%/INPUT.PHONE in a where clause, thus selecting data for the appropriate customer. 

Several shortcuts are possible in parameter references. Input parameters could refer simply to 
attributes in the INPUT element. Thus, input parameter PHONE=7195551212 is equivalent to 
"/INPUT.PHONE=7195551212'\ and the replacement reference %%/INPUT.PHONE can be 
shortened to %%PHONE. 

Data File Formatting 

In another aspect of a preferred embodiment of the invention, after a DDF is fully executed, 
remaining elements are output' using customized formatting options. A system parameter file 
contains formatting commands for each type of element Style. The formatting occurs by processing 
g each element recursively, and applying the formatting commands specific to the element's Style. 

6 

> fh Domains 

g Available formatting styles are gouped into Domains. A Style indicator can reside in several 

pj Domains, with each Domain defining a different format for the Style. Thus, selecting a Domain 

Pi specifies the output format of the DDF. A DDF can specify a default Domain for generated Data 

\ k Files by specifying the Domain in the GEN_TYPE attribute. This attribute is generally in the first 

H element in the document, though it does not need to be. A Client may request a specific output' 

y format by setting the GEN_TYPE attribute in a parameter specification. 

s 

1=* Hierarchical Data Server 

In another aspect of a preferred embodiment of the invention, a computer system is capable of 
receiving requests for data files. Each request for a data file includes a reference to a DDF, plus 
parameters. The Server receives the request, reads the DDF into memory, and performs parameter 
substitutions for any parameter supplied by the Client. The Server then visits each element in the 
DDF, first performing replacement for any replacement operation (references preceded by "%%"), 
then executing the element if possible. Elements are recursively processed. After completion of all 
execution, processing occurs for formatting and output. All elements are again visited, and output 
according to formatting commands based on the indicated Style of the element and the DDF's 
Domain. The fully processed output is then returned to the Client. 



The Server in this example is called a Hierarchical Data Server, or HDS. 
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Document Definition Authoring System 

The job of creating DDFs can be very complex in the enterprise environment. To assist in creation 
and editing of DDF, the present invention specifies a computer system that assists a human in 
constructing DDFs. This computer system is called a Document Definition Authoring System 
(hereinafter referred to as Authoring System). 

Figure 4a shows a preferred implementation of the Authoring System. Figure 4a shows the 
DDF named join.itd. The top window panel shows a graphical tree representation of the 
document which is constructed using the Microsoft Foundation Classes CTreeCtl class. The 
elements include an element of Type "XML" that generates an XML header for the file, an 
Input element that lists the parameters and values for the document, a Database element that 
defines the data source for all subsequent statements, and a PROBLEM element. The 
PROBLEM element has two children elements, each containing an SQL select statement. 

The lower portion of the window shows the same DDF in XML format. This panel is not 
modifiable. 

The View menu includes an option, "Expand Expressions", which executes the elements to 
produce the resulting Data File. The option File/Export performs this function also, storing 
the results to a file. View/Expand Expressions option produces the results as shown in Figure 



Appropriate commands are supplied to insert new elements at a selected location, edit 
existing elements, delete elements, and drag and drop elements to new locations. 

Figure 4c displays the input form used for creating and editing elements. The Style, Type, 
Value, and Attributes fields correspond to components of the element as described earlier. 
The Item field is a synonym (readable label) for the Type, which can be defined in the system 
parameter file, for example, Figure 5, lines 202-203. The Settings box displays the Execution 
Type selection that populates the EXEC attribute, and the Invisible flag, which, when 
checked, causes the introduction of attribute VISIBLE=NO. The button labeled "File. . 
allows the navigation and selection of a file, whose full path will then be supplied in the 
Value field. The button labeled "SQL. . ." initiates the display of the helper form in Figure 4d, 
which assists in the construction of an SQL statement. 
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Children of an element are established by creating a new element as a child of an existing 
element. The user first selects the parent element, then selects a menu option to insert a child 
element. 

Figure 4a displays an icon next to each element. This icon is associated with the element 
Type in the system parameter file, as in Figure 5, line 202. A preferred embodiment also 
allows the user to specify an icon that is externally generated, in which case the icon's file 
name would be specified by the attribute FILENAME in Figure 5, line 202, instead of an 
internal ICON_INDEX. 



A complete set of operations in a preferred embodiment of the invention would include these 
operations: 



Command 


Available when clicked on 


j viperanon 


Insert Root 
Element 


Empty space in left panel 


Create a new root level element 


Edit 


Element Icon 


Edit the type, value, and attributes of an 
element 


Delete 


Element Icon 


Deletes the selected element 


Insert Child 


Element Icon 


Create a child of the selected element 


Insert Before 


Element Icon 


Create an element, place it before the 
selected element. 


Insert After 


Element Icon 


Create an element, place it after the 
selected element. 


Indent 


Element Icon 


Move the selected element to make it a 
child of the element directly above the 
selected element 


Outdent 


Element Icon 


Move the selected element, removing it 
as a child element and making it a 
sibling of its previous parent. 


Drag & Drop 


Click and Drag an Element 
Icon 


Repositions the element to a different 
location in the tree 



XO 



XML Support 

In another aspect of a preferred embodiment of the invention, both the DDF and the Data File follow 
the syntax rules of Extensible Markup Language (XML), a standard published by the World Wide 
Web Consortium. Elements in the XML document representing a DDF can be static or dynamic. 
When a client requests a document from a server, it references the appropriate DDF that is accessible 
from the Server, and passes the server any appropriate input parameters. The DDF is copied, 
parameter substitutions applied, and elements are executed to generate or retrieve the data for each 
element. Some of these elements may be XML links to other XML documents and/or elements. 
These external XML components may themselves be either static or dynamic, and are treated 
appropriately before incorporation into the resulting DF. 

In another aspect of a preferred embodiment of the invention, one of the Hierarchical Data Server's 
defined Domains is XML. Consistent with the formatting features mentioned previously, the Data 
Server can thus dynamically generate XML files on behalf of clients. Clients using the XML domain 
can exploit the rapidly growing number of software tools designed to work with XML. For example, 
XML parsers are available free of charge on the World Wide Web, and the W3C Document Object 
Model, a software component also widely available and built into the Microsoft Internet Explorer 
version 5.0, enable a Client to navigate through the returned Data File using industry standard 
software. The ability to use a free parser and free or inexpensive DOM leads to drastically reduced 
development costs for clients, as the Parsing Code 6 component of an interface no longer needs to be 
developed. 

In another aspect of a preferred embodiment of the invention, the Hierarchical Data Server provides 
the ability to interface to a plurality of dynamic data source types. As examples, the following 
dynamic data source types are supported: 

1 . Open Database Connectivity (ODBC) data sources for any ODBC-compliant data source 
supporting SQL; 

2. Microsoft Data Access Objects and Microsoft JET engine, supporting SQL interfaces; 

3. Microsoft ActiveX Data Objects, supporting a multitude of data sources; 

4. Command line program interface that allows a DDF element to run any program and read and 
format the result into the Data File. 
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Each type of dynamic data source is known by an indicator called an EXEC type. The available 
EXEC types are listed in the system parameter file. When the HDS processes a DDF, each element 
that specifies an EXEC type as an attribute is executed using the specified EXEC type. 

In addition, new dynamic data sources can be defined, and code to implement the interface imported 
into the Hierarchical Data Server using dynamically loaded code modules. A corresponding EXEC 
type must be appropriately placed in the system parameter file, and the DDF element data required in 
the interface must be specified so that the correct information can be passed to the Request Code 4 
component. In this way, an enterprise can implement the Request Code 4 and Server Description 
Code 6 a single time in the Hierarchical Data Server. All clients needing data from a server requiring 
the new interface would request the data from the Hierarchical Data Server and receive the resulting 
data in any supported format. Thus, clients in the enterprise use a standard Parser Code 5 component 
instead of writing new interface code components specific to their interface with the Server in 
question. 

The ability of the Hierarchical Data Server to support new interfaces should not be understated. 
Revisiting the example of Figure 3, the Parser Code 5 is now identical for each Client, and the 
Request Code 4 and Server Description Code 6 is moved to the Hierarchical Data Server and is no 
longer developed in the Client. Thus, Request Code 4 and Server Description Code 6 is developed 
once for each Server for a total of 8 components, plus the Parser Code 5 is developed once for both 
clients for a total of 8 developed components, a dramatic savings over the 22 development 
components in alternate strategies. 

In another aspect of a preferred embodiment of the invention, a Client can request a complex Data 
File from the Hierarchical Data Server in which a plurality of dynamic elements reference data 
generated data within the Data File. For example, DDF element A may instruct the HDS to generate 
a list of rows from a DBMS, which the HDS incorporates as Data File elements. DDF element B 
may reference the said Data File elements, using selected elements as key parameters in its 
generation step. Generated data from one DDF element 

Filtering Data File Output 

In another aspect of a preferred embodiment of the invention, certain attributes in the DDF element 
control whether the resulting elements are included in the output Data File. The attribute 
"INCLUDE", when set to "NO", directs the HDS to exclude the element from the generated Data 
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File. The element is neither executed nor formatted. Generally, the attribute would not be set to the 
literal "NO" in the DDF. Instead, it would be set to a replacement reference that would be 
substituted based on a Client-supplied parameter. For example, an input parameter named 
"DETAIL" might be referenced by an executable element in the DDF by including the attribute 
"INCLUDE=%%DETAIL". A Client wishing the element to be executed and included would pass 
the parameter "DETAIL=YES". A Client wishing to exclude the element would pass the parameter 
"DETAIL=NO" 

In addition, the attributes SWITCH and CASE allow clients to select one of a number of elements to 
execute and include in the output. When the HDS processes an element with attribute CASE, it 
checks the attribute's value and compares it with the value of the attribute SWITCH in the element's 
parent. If the values match, the element is executed and included. Otherwise, it is discarded as in the 
case of attribute "INCLUDE=NO" The value of the SWITCH attribute would likely be a 
replacement reference, so that a Client could select the desired element to execute by setting an input 
parameter, similar to the INCLUDE example above. 

The VISIBLE attribute controls whether an element is included in the output after execution. A 
value of VISIBLE=NO directs the HDS to execute the element as normal, yet do not display the 
resulting element. Children of the element, whether generated via execution or not, are not affected 
by this attribute. 

Multi-threaded Execution 

In another aspect of a preferred embodiment of the invention, the execution of elements is carried out 
in multiple threads. For an element having executable children, setting an attribute 
CHILDREN JTHREADS=YES directs the HDS to spawn a new thread for each child. Each child 
executes to completion in the thread. The HDS waits for all children threads to execute prior to 
finishing processing for the parent. 

Joins 

In another aspect of a preferred embodiment of the invention, two or more elements can be 
joined together in the same sense as a database join. When an element specifies the attribute 
JOIN=YES, or when the predefined element Type is JOIN, the children of the element are 
joined together. When a Join is specified, children elements in Set/Row/Column format will 



be joined together into a single set, which replaces this element. Set/Row/Column format is 
described as follows: . 

Using the Authoring System, document elements are often generated from database sources. 
Since databases generally return rows of data, the format of elements are very consistent. A 
database query returns a set of rows, and each row contains a number of columns. When 
retrieved into an InfoTree Document, this consistent format is called the Set/Row/Column 
format. In XML format, an example looks like this: 

<ORDERS_COMPLETE> 
<ORDER> 

<ORDCD>0000000026<£> 

<SSN>1112233330 
p <SALES_REP> 
P <FIRST>Kirstan</> 



<FIRST>Kirstan</> 
<LAST>Vandersluis</> 

<J> 
<J> 

<ORDER> 

<ORD_CD>0000000045<tf> 
<SSN>1112233330 
<SALES_REP> 
<FIRST>Kirstan</> 
<LAST>Vandersluis</> 
<J> 
</> 
O 



\* 

U 
0 
I* 



P 
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Pi 



<LAST>Vandersluis</> 

O 
O 

<ORDER> 

<ORD_CD>0000000044<^ 
<SSN>1112233330 
<SALES REP> 
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The ORDERS ^COMPLETE element follows the general structure called Set/Row/Column, 
which is roughly equivalent to a database table. An InfoTree document can contain many 
such sets, and in this sense can represent an entire database. InfoTree provides operations on 
Set elements very similar to SQL commands on database tables. Data from elements with 
this structure can also be joined (see JOINKEY, JOIN_SET, JOIN_LABEL attributes) with 
each other, or with any other element with a similar structure, namely elements generated 
from other database tables. 

The HDS operations on Set/Row/Column structures allow the HDS to manipulate data from 
many different system, regardless of the native format of the data Multiple enterprise data 
sources can provide data that can then be joined, selected, and filtered in a myriad of ways. 

Note that the Set/Row/Column format is not restricted to a single, simple element at the 
Column level. As in the case of SALES_REP above, a column element may have 
subelements, and in fact can be arbitrarily complex. 

The Join operation references a JOINJKEY attribute, which specifies the element Type on 
which to Join. The above example can be joined with another set of element data. For 
example, assume another element set specifies phone numbers of sales representatives. A 
portion of the data may look like this: 

<PHONE_BOOK> 
<REP> 

<SSN>111223333</SSN> 
<PHONE>7 1 955 5 1 2 1 2</PHONE> 
</REP> 
<REP> 

<SSN>777334444</SSN> 
<PHONE>3035551212</PHONE> 
</REP> 

Specifying JOIN_KEY=SSN directs the HDS to combine the sets into a single set, resulting 
in the PHONE element being copied into the ORDER set as follows: 



<ORDERS_COMPLETE> 
<ORDER> 

' <ORD_Ct)>0000000026<^ 
<SSN>111223333</> 
<PHONE>7195551212</PHONE> 
<SALES_REP> 
<FIRST>Kirstan</> 
<LAST>Vandersluis</> 
</> 
</> 

<ORDER> 

<ORD_CD>0000000044</> 
<SSN>1112233330 
<PHONE>719555 1212</PHONE> 
<SALES_REP> 

<FIRST>Kirstan</> 

<LAST>VandersluisO 
</> 
O 

<ORDER> 

<ORD_CD>0000000045</> 
<SSN>111223333</> 
<PHONE>7195551212</PHONE> 
<SALES_REP> 

<FIRST>Kirstan</> 

<LAS1>Vandersluis</> 

O 
</> 
<J> 

The Join operation can be performed on any number of children. For a more detailed 
specification of the Join Specification, see Figure 13, Join Code. 



Element Attributes 

Many processing. commands are controlled by element attributes. The form for an attribute is: 
ATTRIBUTED ALUE 

Where ATTRIBUTE is the name of the attribute from the table below, and VALUE is a string 
value enclosed in single or double quotes. 



A list of supported attributes follows: 



Attribute 


Description 


EXEC 


If present, this element is dynamic. This attribute 
designates the execution type (SQL, ActiveX, Join, Shell, 
ADO). SQL takes an SQL statement from the Value field 
and executes it. The target data source of the SQL 1 
statement must be specified by a DBDEHNITION element 
somewhere in the document. The default DBDEFINITION 
is the first instance in the sequence of parent elements, or 
any sibling element of a parent. Alternatively, the 
DBNAME attribute specifies the ID of DBDEFINITON 
element. ActiveX invokes an ActiveX control to generate 
data. Join performs a database Join on the children 
elements. Command executes a shell command to generate 
data. Shell takes a shell command as the value, executes it 
using its stdout as data. 


JOINLABEL 


Designates the Type tag to use for resulting element sets 
from a Join 


JOINJTYPE 


Performs either an Inner or Outer join on the children 
elements 


ROWJTAG 


The Type tag to use in generated row data for SQL rows or 
lines of data generated by a Shell Command. 


COLJTAG 


The Type tag to use in generated column data for SQL 
columns, or token data generated from a Shell Command. 


COL TAGS 


A list of Type Tags to be used to tag columns returned from 





an SQL statement or for tokens generated by a Shell 
Command. 


JOIN_KEY 


The Type tag to look for which defines the element sets to 
join. When the Value field of the appropriately tagged 
subelements are equal, the elements are joined to form a 
single element in the result set 


VISIBLE 


Determines whether the element is visible in the resulting 
document (default is "YES"). If this is 
"CONTENT^ONLY", the value of the element is 
transferred to the resulting document, but not the attributes 
or element type data. 


COL_SEPARATOR 


For SQL elements, designates a separator character 
between columns. If this attribute is present, the columns 
do not have their own start and end tags. The column data 
is instead separated by this character. For shell-generated 
elements, this character string designates the separation 
between tokens, each of which will become elements. If 
this is " " (single space), then parsing removes excess white 
space between tokens. 


DBTYPE 


Type of the database: ODBC, DAO (Data Access Objects), 
ADO (Active Data Objects), XML (Extensible Markup 
Language), ITD (InfoTree DDF) 


DBNAME 


Reference to an element that defines the data source. This 
is the ID of the DBDEFINITON element defining the data 
source. 


HTML_COL_TAGS 


Specifies the tags to generate column headings in an 
HTML generated table. 


COL_LABELS 


List of labels, separated by *|* f designating the column 
header for the HTML table. 


SORTBY 


Designates sorting criteria for a Set/Row/Column formatted 
element. Lists the column tag and optionally whether the 
sort is ascending (ASC) or decending (DEC). Example: 
SORTJ3Y="ORDER_CD ASC". Multiple sort criteria 
can be applied in order of significance, by including more 








than one SORT BY attribute. 




CHDLDRENTHREAD 


Designates whether children of this element are expanded 
in parallel. 




SKIP 


Designates whether this element is skipped. If "YES", this 
element is not expanded, and is treated as invisible. The 
resulting InfoTree document behaves as though this 
element does not exist. 




SWITCH 


Controls the generation of children elements. The value of 
the SWITCH attribute selects the children elements which 
are executed. Any child element with a CASE attribute 
equal to the value of the SWITCH element will be 
expanded. All others will be skipped, as if the SKIP 
attribute is set to YES. 


Q 

ff=B 


CASE 


Controls the generation of children elements. 


pF 


IMPORT 


Specifies the URL of a file to import into this element. 


M 
C5 
fij 

W 




This element is replaced by the root designated by the value 
of this attribute, which may contain an element reference 
(separated by #). 


< 


IMPORT JTYPE 


Specifies the type of resource to import. Values are XML 






orlTD 


M 

W 


PARSE 


For Shell command elements, determines whether the 






command output is parsed (the default) according to 






ROWTAG (per output line), COL_TAG or COL TAGS 
(per "column"). If set to tc NO", the output of the shell 
command is used as the text for the element. If set to 
"XML", the internal XML parser is run with the output of 
the shell command, and the output is parsed into DDF 
format. 




HEDEJVALUE 


This attribute indicates that the generated output element 
will not include the element's value. 









A preferred embodiment of the invention recognizes several special elements Types. These 
elements, when processed, cause useful effects as described below. 




Element Item 


Element Type 


Description 


Database 


DBDEFINITIO 
N 


Defines a Data Source to be used in SQL executions 


Input 


INPUT 


Defines a list of parameters for the document. A 
document generally has at most one element of this 
type. A client requests a document by specifying the 
DDF and a replacement INPUT element. The 
supplied INPUT element is used to replace variables 
in the document. 


Join Children 


DBJOIN 


Specifies that children elements in Set/Row/Column 
format will be joined together into a single set, 
which replaces this element. 


General 


GENERAL 


A generic element type that can be used to house any 
static or dynamic attributes, values, and children. 



Operation of Invention 



Figure 6 shows a flowchart of the HDS portion of the preferred embodiment of the present 
invention. The HDS begins execution as a computer program by performing a System 
Initialization step 30 in which the program is loaded and initialized. During this step, the 
System Parameter file, Figure 5, is read into memory for use during execution of the HDS. 
The HDS then awaits and accepts requests 3 1 from Clients. Communication between Client 
and Server can occur using any available mechanism, for example HTTP. Requests include a 
name to uniquely identify the DDF, plus a plurality of parameters appropriate for the DDF, 
each set according to the needs of the Client. Once the full request is received, the HDS reads 
the full DDF into memory 32, and performs parameter substitution in memory 33. Each 
parameter includes a reference to an element component in the DDF, plus a value to replace 
in the form <reference>=<value>. Parameter substitution is performed in part by using the 
mechanisms of Figure 14, Substitution Code. For each parameter, the reference is passed to 
GetTreeltemComplexPath 410, which returns a pointer to the appropriate element in the 
DDF. Note that an element is coded as a CTreeltem in the code examples. The pointer, now 
pointing to the desired element, provides access to the element. If the <reference> includes 



an attribute name, the attribute with that name in the element in question gets the <value> 
passed in. If no attribute name is part of the <reference>, the <value> is copied into the 
Value for the element in question. This process is repeated for each parameter. 

After parameter substitution, each top-level element in the DDF is processed 34 by a method 
to be described presently. Recall that a DDF is defined as a list of elements. The current 
process 34 simply calls the method Process Element 37, Figure 7, on each element in this list 
Once processing is complete, the resulting data is formatted into a data file 35, using a 
process fully described in Figure 9. Finally, the resulting Data File is returned to the Client. 

Figure 7, Process Elements, describes the method of processing an element 37. First, 
Reference Substitution is performed 38 by the mechanism described in Figure 14, 
Substitution Code. We then check for an IMPORT attribute in the element 39, and if so, we 
check the value of the Import Type attribute to see if it is XML 40, DDF 41, or some other 
supported custom type 42. As can be seen in Figure 7, the element is processed appropriately 
45, 46, 47 based on the value of this attribute. If the value indicates an unknown format, we 
don't import, but instead keep the element as is. 

We next perform conditional inclusion processing the INCLUDE, SWITCH, and CASE 
attributes at items 49, 50, 51, 52, and 53. Next, we determine if this element is executable 55 
based on the value of the EXEC attribute, in which case we execute it appropriately as 
described by 56, 57, 58, 59, 61, 62, 63. If the value of the EXEC attribute is SQL 56, we 
execute the element in the method described by Figure 11, SQL BuildSubtree, which builds 
and returns an element hierarchy that then replaces the current element. If the value of the 
EXEC attribute is COMMAND, we execute the element in the method described by Figure 
13, CMD BuildSubtree, which builds and returns an element hierarchy that then replaces the 
current element. This method can be extended by integrating other execution types 58 and 
63. After execution of the element and replacement with the new element hierarchy, children 
of the original element are copied to each child of the new hierarchy. The copied children 
may be executable elements, and can reference the newly generated elements, as long as they 
have foreknowledge of the element names and structure. Finally, each child of the element, 
whether it was executed as just described, or not 60, is itself processed using the method of 
Figure 8, Process Children. 



Figure 8, Process Children, begins by checking whether the children are to be processed by 

parallel threads 65. If so, a new processing thread is created for each 66. Within the thread, 
* 

Process Element 37 is called for the child element. Once all threads are running, the thread 
processing the parent element blocks 68, waiting for all threads to terminate, or until a 
timeout expires, at which point all child threads are done and we proceed with processing. 

If children threads are not requested 65, we sequentially call Process Element 37 for each 
child. Note that for both the multi-threaded and single-threaded cases, we are recursively 
calling Process Element 37, thus systematically processing our way through the element 
hierarchy in a depth-first sequence. After all elements are processed 69, we perform post- ' 
processing operations. In particular, we check for a Join request 70, and if requested, we join 
the plurality of children as described in 71 . At this point we are done processing an element, 
and we may optionally remove all elements that have an attribute VISIBLE=NO. If we 
choose not to remove these elements here, we remove them later in the formatting procedure 
of Figure 9. 

Figure 9, Format Memory into Data File, first establishes the Domain of the format 76. Note 
that the Client may have specified the format in a parameter. We next prepare to iterate 
through the list of top-level elements 77, and for each top-top level element we find 78, call 
Output Element 79, whose method is described in Figure 10. If no elements remain, we are 
done formatting 80. 

Figure 10, Output Element, provides the mechanism to format and output the element to the 
Data File. We begin by determining the Style of the element based on the element's Style 
indicator and the current Domain. Figure 5, System Parameter File, shows the format of 
example Domains and Styles. For example, Line 4 begins the Domain XML, which we will 
match if the current DDF's GENOTYPE also is XML. The current element may have a Style 
of "ELEM", which we will match against the Style of Line 5. Line 6 provides a formatting 
string. The formatting string is output to the Data File, with special tokens indicated by 
being replaced by components of the elements. The following substitutions are performed: 
%T is replaced with the element Type, %V is replaced with the element Value, %A is 
replaced with the element's attribute list, each attribute constituting a key-value pair, and %C 
is replaced by the output of the children of this node. Note that here again, we recursively 
define a mechanism that will process and format elements in a depth-first fashion. In the 
current example, our format string is "<%T%A>%V%C<?%T>". If our element Type is 



"ITEM", and we have one attribute NUM=1, and the element Value is "TABLE", the output 
would be "<ITEM NUM=1>TABLE</TTEM>". Figure 10 describes this substitution in84, 
87, 88, 89, 90, 91, 92, 93, 95, 96, 97, 98, 99, and 100. Custom formats may also be processed 
as in 85 and 86. Elements that have attribute VISIBLE=NO are not output, but if %C is 
specified in the format string, the children elements are processed here as usual. 

Figure 1 1, SQL BuildSubtree presents the mechanism for executing an element that has 
execution type EXEC=SQL. The SQL statement is taken from the element's Value field 103. 
We then determine how to format the resulting rows 104 and columns 105 in terms of 
element components. This means we need to determine the Type of the generated elements. 
Next, we secure the database connection 106 and open the connection 107 if it is not open 
already. Then we execute the SQL on the connection 108 and begin reading database rows 
109. When we get a row 1 10, we create a new element as described in 106, then process the 
columns in the row 113 until there are no more. For each column 1 14, we create a new 
element, giving the element the Type as described by 1 15 and the value of the database 
column 117. We process all columns in the row in this manner until no more columns are 
available, then move to the next row 1 16. We process all rows as described above until no 
more are available, then we return the newly created element hierarchy or subtree 111. 

Figure 12, CMD BuildSubtree presents the mechanism for executing a command line 
program and formatting the results into an element hierarchy. We retrieve the command line 
program (also called shell program) from the element's Value field. We next check for the 
attribute PARSE 121, and if present, check if its value is XML 122. In this case, we run the 
command line program, and feed its output into an XML parser 123, reading the resulting 
data into DDF format and returning it 124. If the value of the PARSE attribute is something 
else, we check to see if this is a request to run a custom parser (such as an SGML parser, or 
any other custom parser) 127, then we run the command line program and feed its output into 
the custom parser, which reads the resulting data into DDF format 128, which we return 129. 

If we did not find the PARSE attribute, we proceed with processing the element. We read the 
formatting commands as described in 125 and 126, which directs us how to create elements, 
and what the element Types will be. We then execute the command line program 130, and 
then read lines of data 13 1 as long as we can get another line. For each line we read, we 
create a new element as specified in 135, then we determine if we need to create column level 
elements based on the presence of the COLJTAGS or COLJTAG attributes 136. If not 



